Space & Astronomy/Space and Astronomy (October 1993).iso/mac/VIEWERS/AMIGA/LHARC130.ZOO/LHArc/lharc.doc

Text File | 1990-12-06 | 36KB | 917 lines

________________________________________________________________________
------------------------------------------------------------------------


                        LHARC        vers. 1.30

                        for the Commodore AMIGA
         Compatible with version 1.13 of Lharc for MSDOS systems


                            by Paolo Zibetti

          Fidonet 2:331/101.6
          Internet/UUCP: [e-mail]


                 (assembler routines by  Paolo Toccaceli)

------------------------------------------------------------------------
 IMPORTANT NOTICE:  This program is copyrighted by Paolo Zibetti, but can
 be freely distributed, providing that the following rules are respected.
 - No change is made to the program nor to the accompaning documentation
 - The package is always distributed in its complete form consisting of
   (at least) the 4 files: "Lharc", "Lharc.doc", "Changes" and README.1st.
 - Every form of distribution is allowed and encouraged, but no fee can
   be charged for this program exept for, possibly, the cost of magnetic
   media and/or disk duplication and shipping.
 - Inclusion in PD software libraries such as Fish Disks is allowed,
   provided the fees charged for these disks are comparable with those
   charged by Fred Fish.
 - The program cannot be distributed in any commercial product without the
   written consent of the author.
   Software developers interested in using Lharc for distributing thier
   products should contact me to obtain my explicit permission (what I
   generally ask in return is simply to receive a free copy of thier
   products).

 By copying, distributing and/or using the program you indicate your
 acceptance of the above rules.

 Also remember that this program is supplied 'as is': the entire risk as
 to the quality of the program is to the user. In no event will the author
 be liable for direct or indirect damage or loss resulting from the use
 of this program.
------------------------------------------------------------------------

________________________________________________________________________
------------------------------------------------------------------------










 --- Introduction ---

Lharc is an archive program such as Arc and Zoo. It can store several
files in one archive in a compressed form which is generally more
efficent than that used by Arc and Zoo.  It also supplies all of the
archive handling capabilities that an archive program should have.
In particular it is able to store an entire directory tree
(including empty directories) with one single command. This enables
you, for example, to store an entire floppy-disk with a single
command and the resulting archive is usually shorter than those
prodeced by Warp or even LhWarp (see the -r switch).
Another important feature of Lharc is its ability to preserve the file
attributes (see the -a switch) and filenotes (i.e. the comments that
AmigaODS can associate to each file).
Its only weakness is compression speed: Zoo 2.0, for example, is
faster, but if compression efficency is more important for you than
compression time you'll surely appreciate this progam. (anyway
decompression is much faster than compression)










 --- Before starting ---

Lharc is a 'pure' program, i.e. you can make it resident via the
'resident' Amigados command just like any other command found in the
c: directory. Keeping Lharc resident will greatly facilitate users
who make an heavy use of Lharc (especially those who don't have an
hard disk).
If you have just received Lharc, beware that some copy programs and
some archivers (including the zoo archiver which is used for
distribution of Lharc) don't preserve file attributes, so the 'p'
flag may not be set for the Lharc executable and Amigados won't
understand that Lharc is a pure program. If so, just type the
following line at the CLI prompt:

 protect Lharc p add










 --- How to use ---

Lharc is run from CLI with the following command line:

  Lharc [<switches>] <Command> <Archive> [<dest path>] [<file patterns>]

items in square brackets are optional.




<Command> can be any of the following (case is not significant):


  e,x  extract files from archive
       Extracts files from archives. If you specify some file names
       or patterns only those files satisfying the patterns are
       extracted, otherwise all the files in the archive are
       extracted.
       While extracting files, Lharc checks if a file by the same
       name already exsists in the destination directory and prompts
       you before overwriting the old file with the extracted one
       (unless you specified the -m switch)
       By default, if the files have a path name stored in the archive, they
       are extracted with their path and needed directories
       are automatically created; use the -x0 switch to ignore path names.
       See below under '<dest path>' for a discussion on where the
       extracted files are stored.


  l    show archives contents
       Displays the names of the files in an archive along with their
       date, time, CRC, compression type, original lenght and
       compressed lenght.
       If the -x switch is specified file names are listed complete
       with their path (if present in the archive), otherwise
       only the name of the files is listed.
       The 'l' command won't list the comments (filenotes) that may be
       assiciated with a file: use the 'v' command to see them, too.


  v    Same as 'l', but default is to display full pathnames: i.e.
       the 'v' command is equivalent to the 'l' command with the -x switch;
       on the other hand the 'l' command is equivalent to the 'v' command
       with the -x0 switch.
       Moreover 'v' will also show any filenote (i.e. comment)
       associated with the files; filenotes, if present,
       are listed on a separate line preceded by a colon
       (i.e. in the same format used by the AmigaDOS 'list' command).


  p    extract and print files to screen
       same as 'e' and 'x', but extracted files are sent to stdout


  t    test archive integrity
       Checks CRCs and checksums to ensure that the archive is not
       corrupted. Lharc will test all the files on the archive, one
       after each other, printing "OK" to the right of the file names
       which are OK and "WARNING: CRC check failed" to the right of
       file names that are corrupted. At the end of the test the
       message "Operation successful" means that all the files tested
       were OK, while the message "Operation not totally successful"
       means that some files in the archive were corrupted (so you
       will know of a corrupted file even if the warning message
       relating to that file has scrolled away on the screen)


  a    create archives or add to existing archives
       Files are stored in alphabetical order, unless you change
       this with the -S switch. Note however that sorting only
       applies to the files beeing added in the current session,
       i.e. if you add files to an existing archive containing
       other files, the new files will be stored, in alphabetical
       order, AT THE END of the archive: old and new files won't be
       intermixed to preserve global alphabetical order.
       If you try to archive a file and a file by the same name
       already exists in the archive the file will not be added
       and a message will be printed on the screen to inform you.
       By default only file names are stored in the archive, use the
       -x switch to store file names complete with their paths.
       Also, by default file attributes are not stored, use the '-a'
       switch to obtain this.


  m    move files into archivs
       Same as add, but deletes original files after archiving them


  d    delete files from archives
       You can delete from an archive a maximum of 150 files at a time,
       if you find that they are too little, please let me know!


  u    update files in archives
       Same as with the 'a' command.  However, if a file already
       exists in the archive, LHarc will check its time stamp and will
       keep the newer one and ignore the older one.


  f    freshen files in archives
       Replaces a file in the archive with the newer one only if a file
       with the same name already exists in the archive.
       Otherwise, no action is taken.








<Archive> is the name (eventually preceded by a path) of the
archive you want to work on. If no extension is specified the default
extension .LZH is used.
With the 'l' (or 'v'), 'e' (or 'x'), 'p', 't' and 'a' commands you can
work on multiple archives by using wildcards (see 'file patterns'
below for a list of accepted wildcards). For example "lharc v *.LZH"
will show the contents of all the archives in the current directory,
while "lharc x *.LZH *.c" will extract all the C source files
contained in all the archives in the current directory.







[<dest path>]
This parameter is significant only with the 'x' (or 'e') command.
It tells where to put the extracted files; if not specified, extracted
files will go to the current directory.
Please note that this paramenter must always end with '/' or ':'
otherwise it will not be recognized as such and will be considered
as one of the file patterns.
If the path specified by <dest path> (or equivalently the path stored
in the archive) does not already exist, you will be prompted if you
want new directories to be automatically created (unless you specified
the -m switch, in which case directories will be created without any
prompt).







[<file patterns>] rappresents an optional number of file names
or file patterns. They indicate which files to
extract/compress/list/delete, ecc.
Accepted wild cards are the standard AmigaDOS '#' and '?' plus the '*'
which is a synonim of '#?'. Since however the asterisk is a valid
caracter in AmigaDOS file names I provided the '**' sequence as an
escape.  So if you want to refer to a file name containing an asterisk
just double the asterisk in the file name.
Example:  '*.c' is equivalent to '#?.c' and refers to all the files
ending with '.c', while 'my**file' refers to the file 'my*file'.








[<switches>] rappresents an optional number of switches that are used
to change the behaviour of the program.
A switch is composed by  a leading '-' followed by one letter; unlike
commands which are case insensitive, switches are case sensitive.
An important point is that if you want to specify more than one switch,
every switch must be preceded by its own dash, i.e. to activate the 'x'
and 'm' switches you must enter "-x -m" and NOT "-xm".
You can store your favourite switch configuration in an environment
variable (see below) so that you don't have to type them every time.
All the switches that don't take a parameter can be followed by a '0'
which turns off the function, while the switch alone or the switch
followed by a '1' turns the function on: i.e. -x means "use extended
file names",  while -x0 means "don't use them". So you can override
the default settings or the settings you specified in the environment
variable "LHARC".
Default value for every switch is off, exept for the -a switch which is
on with all the commands and for the -x switch which is by default on
with the 'x' 'e' 'd' 't' and 'v' commands and off with the other
commands.


Here is a summary of the available switches:



  -p  (p)ause after loading        [note that this is lowercase 'p']
      Causes Lharc to wait for the user to press RETURN before
      executing a command. This allows floppy disk users to swap disks
      after loading Lharc.




  -m  no (m)essage for query
      Suppresses all the queries Lharc normally issues before
      overwriting existing files or before creating new directories
      If you specify this switch Lharc will behave as if you choose
      the default action (indicated by an uppercase letter) in
      response to all the questions. This switch also disables
      autoshowing of files (see 'Autoshow files' below)




  -x  use e(x)tended file names
      By default, LHarc stores only the file names of
      files and disregards the names of the directories in which
      they reside.  This switch, used with the 'a' command, tells LHarc
      to extend all file names with directory names; with the 'x' 'e' 'd'
      't' and 'v' commands the -x switch is automatically turned on: use
      -x0 if you want to turn it off thus ignoring pathnames with these
      commands.




  -n  no progress i(n)dicator
      Suppresses the display of the number of bytes beeing processed
      during compression or decompression. May be useful if you
      redirect to a file the output of Lharc.
      Note: this version of Lharc allows the -N switch as a synonim of -n :
      but this might change in future versions, so preferibly use the
      lowercase letter.




  -w  set (w)ork directory
      Use this switch to choose your own directory for temporary files.
      The directory name must immediatly follow the letter 'w' without
      any leading space, i.e. to set the 'temp' directory on your
      hard-disk as the working directory you must write "-wdh0:temp".
      See below "Temporary files" for a discussion on where temporary
      files are stored in the absence of this switch.




  -P  set (p)riority          [note that this is uppercase 'P']
      Use this switch to set the priority with which Lharc will be
      executed. Priority must be in the range -5..+5  and must
      immediately follow the 'P' letter without blanks in between.
      By default Lharc is excuted with the same priority of
      the task that invoked it; using this switch will set the new
      priority immediatley after loading and will set back the priority
      to the original value immediately after terminating.
      If you want to do something else with your Amiga, for example
      editing a letter, while Lharc is compressing a long file, I
      suggest that you set Lharc's priority to one less than that of
      the other program, i.e. if you started your editor with the usual
      priority of zero then invoke Lharc with the '-P-1' switch to set its
      priority to -1




  -a  consider file (a)ttributes
      Lharc can ignore file attributes (i.e. the flags
      indicating protection from deletion, and so on) for maximum
      compatibility with the MSDOS version: in other words it can
      store files with an attribute bit pattern which is suitable for
      MSDOS machines and, during extraction, ignore the
      attributes stored in the archives, setting the attributes of the
      extracted files to the usual '----rwed'.
      Alternatively Lharc can preserve the protection bits by storing
      them in the archive and then restoring them during extraction.
      In Lharc version 1.3 and higher, this switch is by default on,
      i.e. file protection bits will be preserved: use -a0 to turn it of
      to achieve full MSDOS compatibility.
      Remember that, to effectively preserve file attributes, you must
      use the same setting for this switch both during compression and
      during extraction.
      Of course AmigaDOS file attributes are meaningless to MSDOS and
      vice-versa; so extract files with the -a switch only if you are
      sure that they contain AmigaDOS file attributes and similarly
      compress files with the -a switch only if you are sure that the
      archive will be unpacked only by Amigas and not by MSDOS
      machines. (Anyway no harm is done if this rule is not respected:
      extracted files will simply have strange attributes)




  -u  convert file names to (u)ppercase
      By default Lharc stores file names/paths with thier original case,
      if you use this switch they will be converted to uppercase.
      See below 'Compatibility' for a possible use of this switch.




  -r  (r)ecursively collect files
      This switch instructs Lharc to search for files matching the
      specified patterns not only in the specified directories, but also
      in all the subdirectories that may be found in the specified
      directories. For example:

      "Lharc -r a archive.lzh df1:source/*.c"

      will search for files whose name ends with ".c" in "df1:source/"
      and in all the subdirectories that may be contained in the
      "df1:source" directory.
      Another example:

      "Lharc -r a archive.lzh df1:*"

      will archive the entire disk in drive df1:, including all its
      subdirectories.
      Very powerfull, isn't it ?
      The -r switch can optionally be followed by a 'e' (i.e. -re): this
      tells Lharc to store empty dirs as well. By 'empty dir' we mean
      dirs which are actually empty or dirs which contain no files
      matching the patterns specified on the command line.
      This option allows you to perfectly re-create a directory tree, but
      remember that archives containing empty dirs are NOT compatible
      with MSDOS-Lharc 1.13; so, use the 'e' option only if you are sure
      that the archive you are producing will be unpacked on Amiga
      machines only.
      When you specify the -r switch, files are always stored with their
      path name, i.e. the -r switch automatically turns on the -x switch,
      too.




  -S  Set (s)orting criteria          [note that this is an UPPLERCASE S]
      This switch sets the sort criterium for files beeing added to
      archives. The '-S' must be immediatly followed by one to four
      characters, i.e. -Sxyzw  where
      'x' can be any of the following:
           0  Don't sort files
           a  Alphabetical sort    [default]
           c  Chronological sort
      'y', if present, can be any of the following:
           a  Ascending order      [default]
           d  Descending order
      'z', if present, can be any of the following:
           i  Case insensitive alpha-sorting      [default]
           s  Case sensitive alpha-sorting
      'w', if present, can be any of the following:
           l  Local sorting      [default]
           g  Global sorting
      The above parameters must be specified in the order given above,
      for example to choose between local or global sorting you must
      necessarly also specify the three preceding parameters.
      The -S0 option is useful if you want to create an archive in
      which files appear in a given order: the -S0 switch
      tells Lharc to add files in the same order as they were
      specified in the command line (or in the '-i' file).
      The 'global/local sort' parameter needs some more explaination:
      'global sorting' means that files will be stored in strict
      alphabetical or chronological order; 'local sorting' means that
      sorting will be local to each subdirectory with more 'nested'
      subdirectories pushed at the end of the archive.
      As an example, look at the following lists of files: the left
      coloumn is sorted with alpha-global sorting, the right one is
      sorted with alpha-local sorting


     GLOBAL SORTING                             LOCAL SORTING

     Announcement                               Announcement
     README                                     README
     include/common.h                           include/common.h
     include/foo/abc.h                          include/global.h
     include/foo/rexx/rexx.h                    include/rexxbind.h
     include/foo/rexx/rexxglue.h                l/xyzzy-handler
     include/global.h                           lib/ps.library
     include/old/foo/abc.h                      s/.xyzzyrc
     include/old/poof/xyz.h                     s/add-2-startup-sequence
     include/poof/poof.h                        src/Makefile
     include/poof/xyz.h                         src/foo.c
     include/rexxbind.h                         src/poof.c
     include/xyzzy/incl1.h                      src/xyzzy.c
     include/xyzzy/incl2.h                      src/zot.c
     include/xyzzy/incl3.h                      utils/help
     l/xyzzy-handler                            utils/more
     lib/1.3/foo.library                        include/foo/abc.h
     lib/1.3/old/foo.library                    include/poof/poof.h
     lib/2.0/foo.library                        include/poof/xyz.h
     lib/ps.library                             include/xyzzy/incl1.h
     s/.xyzzyrc                                 include/xyzzy/incl2.h
     s/add-2-startup-sequence                   include/xyzzy/incl3.h
     src/Makefile                               lib/1.3/foo.library
     src/foo.c                                  lib/2.0/foo.library
     src/old/poof.c                             src/old/poof.c
     src/poof.c                                 include/foo/rexx/rexx.h
     src/xyzzy.c                                include/foo/rexx/rexxglue.h
     src/zot.c                                  include/old/foo/abc.h
     utils/help                                 include/old/poof/xyz.h
     utils/more                                 lib/1.3/old/foo.library


      Finally some examples:
         -Scd          Sort chronologically in descending order
         -Sc  or -Sca  Sort chronologically in ascending order.
         -S0           Don't sort at all
         -Sads         Sort alphabetically in descending order (case
                       sensitive)
         -Saail        Sort alphabetically in ascending order; sorting
                       will be case-insensitive and will be local to
                       each subdirectory; this is also the default action
                       which is taken if you don't specify this switch.




  -b  Set I/O (b)uffer size
      Big I/O buffers can considerably speed up some operations of Lharc
      (espacially with hard disks) however if you are low on memory you
      may prefer to use small I/O buffers.
      This switch lets you set the amount of memory that Lharc will use
      as an I/O buffer: the number of Kbytes of memory to be used must
      immediately follow the 'b' without any spaces in between, e.g.
      -b20 tells Lharc to use 20 kbytes of memory for I/O buffers.
      Any number between 6 and 37 is valid, default is using 11 Kbytes:
      if you are low on memory you can lower this amount, but if you have
      plenty of memory I suggest that you rise it.
      I suggest that you set this switch at the value you like in the
      environment variable 'LHARC' (see below) so that you don't have
      to specify this switch every time you invoke Lharc.




  -f  ignore (f)ilenotes
      By default Lharc archives files complete with their comment
      (filenote). If you set this switch, filenotes won't be stored in
      archives and files beeing extracted won't have any filenote
      even if it was present in the archive.
      There is no compatibility problem, but if you are not interested
      in filenotes you may set this switch to reduce the archive size
      (filenotes are stored in uncompressed form, so if you have long
      filenotes they can increase the size of the archive).




  -d  set archive's (d)atestamp
      By default archives created or updated by Lharc will have a
      datestamp corresponding to the date of creation of the archive.
      If you set this switch, on the contrary, archives created or
      updated by Lharc will have the same date as the newest file
      contained in the archive.




  -c (c)onfirm files
      If this switch is set, Lharc will ask you for confirmation
      before archiving or extracting a file. This allows you to
      specify a large set of files through the use of wild-cards and
      then select which of them to consider in an interactive way.
      If you for example typed: "Lharc -c a test.lzh *.c" all the
      files ending with '.c' in the current directory will be
      presented to you with the message:

      "Archive file xxx.c?  [(Y)es, (n)o, (a)ll, n(o)ne]"

      You have four alternatives: to choose between them just type
      the letter indicated in parenthesis and press return. The '(Y)'
      is printed in uppercase to remember you that this is the
      default action which is taken if you simply press return.
      The meanings of the four alternatives are:

      yes:  archive the file
      no :  don't archive the file
      all:  archive this file and all the following files without
            asking anymore for confirmation.
      none: don't archive this file nor any of the following files

      This switch is ignored if the -m switch is active.




  -i read (i)nput from a file
     This switch tells Lharc to read the list of files to act upon from
     a file. The file name must immediately follow the '-i' without any
     speces in between. If the -i switch is specified alone (i.e.
     without a filename) the file list is read from stdin.
     For example:

     Lharc -idf1:list a foo.LZH

     will add all the files specified in the 'df1:list' file. This file
     can contain ordinary file names or file patterns to be added, each
     on a separate line: a file name is assumed to be
     terminated by a space or a tab, everything on the line after the
     first space or tab is ignored. If a file name contains spaces, it
     must be enclodsed in double quotes.
     The ability to read the list of files from stdin allows the use of
     Lharc in a pipe of comamnds, for example:

     list since today | Lharc -i a foo.lZH

     will archive all the files in the current directory which were
     created today. (A shell that supports the '|' character is
     required)
     Note that you can also specify some files on the command line, if
     you want; the command:

     Lharc -idf1:list a foo.LZH hello.c bye.c

     will add the 2 files 'hello.c' and 'bye.c' plus all the files
     specified in the file named 'df1:list'.
     As mentioned above, although this is of less frequent use, you can
     also use the -i switch to supply a list of files to be extracted,
     printed, listed, ecc.
     Please note that, in this vesion of Lharc, the number of filenames or
     patterns that can be specified through the -i switch is limited to
     about 120: this limitation will be removed in the future.











 --- Setting switches in an environment variable ---

   You may set any of LHarc's default switches with the environment
   variable 'LHARC':
   So, if you, for example, want to always set the archive's date to
   that of the newest file in the archive, use the maximum allowed I/O
   buffer size and use 'dh0:mytemp/' as a working directory, you simply
   type:

   SenEnv LHARC  "-wdh0:mytemp -d -b37"

   (don't forget the quotes): now Lharc will behave as if you typed
   the above switches every time you invoke it. You can insert the
   setenv command in your startup-sequence so that it's automatically
   executed every time you turn your computer on.
   Of course, you can always override the default settings
   estabilished in the enviroment variable with the command line: for
   example a '-d0' in the command line will override the '-d' found
   in the above enviromnet variable.
   Please note that the 'setenv' command is only available in
   Workbench 1.3 and higher: if you are using older versions of the
   O.S. this feature is not available.










 --- Autoshow files ---

Suppose that your archive contains an important text file that you
want to be sure it will be read by the guy who unpacks the archive.
The file may for example contain a copyright notice or some special
instructions for unpacking.
For this purpuse Amiga-Lharc introduces autoshow files: while
unpacking an archive, if Lharc encounters a file whose name ends with
".TXT.DISPLAYME" (case is not significant and quotes must not be
included, of course), it first extracts the file (removing the .DISPLAYME
extension) and then displays in a window the text found in that file
waiting for the user to press RETURN before proceeding.
You can add as many autoshow files as you want, for example one at the
beginning and one at the end of the archive.
Autoshowing of files is disabled when the -m switch is active so that
a non-interactive unpacking session is allowed.
Lharc uses the standard CON: device to open a window for displaing text,
so you can insert ANSI codes in your autoshow files to make your
messages nicer. Lharc will adjust the size of the window according to
the number of lines contained in the text file, but the maximum allowed
size is that of an NTSC screen (200 pixels), so if your text is longer
than 20 lines it will scroll away.
Finally, please note that this feature is unique to the Amiga version of
Lharc (for now...) so remember that if your archive will be unpacked on
another machine (or an an Amiga using Lharc version 1.0 or lower)
autoshow files will simply be extracted without displaying them on the
screen; anyway your important text file will still be there for later
reading by the user and no compatibility problems will arise.











 --- Temporary files ---

While compressing files Lharc creates a temporary file called
'Lharc.TMP_XXXXXX' where XXXXXX is a hex digit representing the address
of its own Task structure as returned by Exec's FindTask(NULL).
The reason for the XXXXXX part of the name is that if you run multiple
copies of Lharc at the same time each copy will create its own temporary
file with a different name (usefull for multiline BBSes for example).
Here is how Lharc decides where to store temporary files.
If you specify a path with the -w switch temporary files are stored
there, otherwise if the T:  logical device is assigned they will be
stored in that directory, otherwise they will go to the current
directory.
If you are not using the -w switch, in order to increase compression
speed, I raccomand that you assign T:  to a directory in the ram-disk.
Note however that T:  is usually automatically assigned to 'ram:t' in
the startup-sequence of the standard Workbench, so, unless you have
modified the startup-sequence, you don't have to worry about this.













 --- Corrupted archives ---

This version al Lharc for the Amiga has the capability of automatically
handle corrupted archives.
A Lharc archive is made up of several compressed files each precedeed by
a header containing information about file name, date, lenght,...
To ensure that the archive is not corrupted the header also contains a
16 bit CRC of the file and an 8 bit checksum of the header itself.
If during extraction Lharc finds a corrupted file (i.e. one whose CRC
does not match with the one stored in the header) the file is extracted
anyway, but a warning is printed on the screen.
The worst case comes when the header of a file is corrupted: in this case
the file cannot be extracted even if the file itself is not corrupted.
In this case Lharc will automatically skip the corrupted entry by
starting a search for the next valid entry in the archive and will
print a message like "WARNING: skipping extraneous/corrupted data"
The reason for which it says "extraneous/corrupted" is that an Lharc
archive might happen to contain parts that Lharc cannot recognize as valid
archive entries even it's not corrupted. This happens when you are
extracting files from a self-extracting archive produced by the MSDOS
version of Lharc, since a self-extracting archive contains 8086
extraction code which the Amiga-Lharc sees as extraneous data.
The only extraneous data which is passed without warnings is additional
bytes at the end of an archive: since they are likely to consist of
zero padding due to XMODEM transfer they are totally ignored.












 --- Return codes ---

When Lharc finishes his work, it returns to the operating system one of
3 possible return codes:

 0  Everything was OK  (the message "Operation successful" is printed on
    the screen).
 5  Lharc finished its work, but something went wrong, for example Lharc
    encountred a corrupted entry in the archive, but was able to continue
    extracting/testing the rest of the archive (the message "Operation not
    totally succesful" is printed on the screen).
 20 A fatal error occurred and Lharc was unable to continue its work (an
    appropriate message exlpaining the probelm is printed on the sceen)

Thus you can test the succes of operation in your script files by means
of the 'failat' statement and the 'if warn' test.











 --- Bugs ---

No known known bugs remain in this version.











 ---- Compatibility ---

This program is aimed at full compatibility with the MSDOS version
1.13 of Lharc.
A few little problems might arise from some file names that are legal
under AmigaDOS, but illegal under MSDOS. As a matter of facts AmigaDOS
allows a wider range of file names (almost every caracter in the ASCII
set is allowed and file names can be longer than 8 characters). For
the greatest convenience of Amiga users, I choose not to restrict the
file name range to accomplish the MSDOS rules, but if you expect that
your archives will be unpacked on an MSDOS machine you'd better
rispect the MSDOS limits.
Also note that, although MSODS Lharc version 1.13 CAN extract files
whose names contain lowercase letters, its pattern matching functions
don't work properly with lowercase file names. So if you want to
extract an Amiga-created archive on an MSDOS machine by using pattern
matching functions (for example to extract only some files instead of
the whole archive) you have to create the archive on the Amiga with
the -u switch.
Finally, to attain 100% compatibility you shuold not use the '-a' switch
nor the '-re' switch ('-r' alone is, on the contrary, OK)
(see above in the descriptions of these switches for more details)

Also note that the MSDOS version of Lharc has the additional
capability of extracting files from archives produced by Larc (a
pupular Japanise archive program): this feature will not be
implemented in the Amiga version.












 ---- Acknowledgements ---

First of all I give credit to Haruyasu Yoshizaki for devising such an
efficent compression algorythm as LZHUF.
Second, since the source to the MSDOS version of Lharc is scarcely
portable (lots of 8086 assembler ruotines and MSDOS-dependent C
functions), I had to rewrite the program from scratch. Note however
that for LZHUF compression/decompression I have used as a starting
point a 'C' source for an example of single file compression
which I found on a BBS. Although the code has been now remanaged (and
partially rewritten in assembler by Paolo Toccaceli and me) it
nevertheless was invaluable to me.
For sake of correctness I quote here the the header found on this
source:

/*
 * LZHUF.C English version 1.0
 * Based on Japanese version 29-NOV-1988
 * LZSS coded by Haruhiko OKUMURA
 * Adaptive Huffman Coding coded by Haruyasu YOSHIZAKI
 * Edited and translated to English by Kenji RIKITAKE
 */

I whish to thank the above people whose work has been of
foundamental importance for this project.
Thanks to Stefan Boberg for suggesting how to store filenotes in the
archive structure that didn't provide space for them.
Many thanks also go to all the people who contributed with suggestions
and bug reports and particularly to Luca Spada for his invaluable beta
testing work.












 --- How to contact me ---

Please send suggestions, comments and bug reports to:

Paolo Zibetti          Fidonet: 2:331/101.6
                 Internet/UUCP: [e-mail]

node 2:331/101 (AmnesiA) is also the official distribution node for
Amiga-Lharc: you'll always find the latest version available on this
board. If you are an officially listed FidoNet node you can f'request
the latest version of Lharc with the magic file name AMILHARC.

Amnesia (2:331/101)  phone [phone]  (v32/HST, upto 14400 bps)